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ABSTRACT 


This User's Guide is an addendum to JPL Publication 77-2A» 

Revision 1, Software Design and Documentation Language , by Henry Kleine* It 
is not n complete description of SDDL) but rather a description of the changes 
introduced in SDDL Release 4 (the Pascal implementation). Those changes 

include a munbe? of new capabilities, plus some changes to make the language 

% 

more consistent and easier to use. Incompatibilities with earlier versions 
arc limited to certain of the directive ratements. 



INTRODUCTION 


SDDL, first implemented in the SIMSCRIPT language , has been available 
only on computers which support SIMSCRIPT, all large machines. By the summer 
of 1979 the need for an SDDL processor which could be used on a wider range of 
computers, including minis and micros, led to a decision to build a new 
implementation. Pascal was chosen as the new implementation language because 
of its attractiveness as a high’'level language and because of its iimnediate or 
anticipated availability on a wide variety of machines. It was felt that by 
restricting the code to standard Pascal as defined in Jenben and Wirth, Pascal 
User Manual and Report , portability problems would be kept to a minimum. 

A new implementation of SDDL was also seen as an opportunity to 
correct several deficiencies and ambiguities in the language and to add a 
number of new capabilities. Bach change introduced was evaluated with a view 
towards simplifying the language and making it more consistent and more easily 
understood. However, care was taken to maintain upward compatibility with 
earlier versions wherever possible. 

SDDL Release 4 (January 1981) is the result of this implementation 
effort. Although it contains a number of changes, its only incompatibilities 
with earlier versions are limited to certain of the directive statements. 
Therefore, with only a few minor chafiges to these statements, any existing 
SDDL source file can be correctly processed by the new version. 

This document describes the language changes and additional features 
of the new processor. It is an addendum to JPL Publication 77“24, Revision 1, 
Software Design and Documentation Language , and represents a preliminary step 
to rewriting that document. 
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CHANGES INT ?;ODUCED IN SDDL RELEASE 4 

■Illllll *> J l m I I’W l I 

(Those changes which violate atridt upward compatibility are marked with an ♦) 


!» 


1) Lower case letters are now recognised and treated as distinct 0rom 

their upper caae counterparts. Thus, for example, ABC, abc, AbC, and 
aBc are all distinct identifiers. Directives are only recognised in 
upper case . 


2) A #KEYWORDS directive has been added to give the user a choice 

between several rets of built-in keywords. Note tha this directisre 
nulls out all currently defined keywords before substituting the 
selected set. The directive exists in tour forms: 

a. ^KEYWORDS 


#KEYWOIlDS STANDARD 


Nulls out all currently defined keywords and establishes 
the standard (default) set* 


Module 

Structures 


Block 

Structures 


Initiator 


PROGRAM 


PROCEDURE 


FIRST 


IF 


SELECT 


LOOP 


Terminator 


ENDPROGRAM 


ENDPROCEDURE 


ENDIF 


ENDSELECT 


ENDLOOP 

REPEAT 


Escape 


EXITPROGRAM 


EXITPROCEDURE 


EXITLOOP 

CYCLE 


Substructure 


NEXT 


ELSE 

ELSEIF 


CASE 




















b. IKEYHORDS PASCAL 


Nulls out all currently defined keywords, deCinea " as a 
nark character, and establishes the followings 



Initiator 

Terc^inator 

Escape 

Subatructure 

Module 

Structures 

PROGRAM 

"ENDPROGRAM" 



PROCEDURE 

"ENDPROCEDURE" 



FUNCTION 

"ENDFUNCTION" 



"DIBCLARATIONS*' 

"ENDDIiCURATIONS" 



Block 

Structures 

BEGIN 

END 



RECORD 

END"RECORD" 



IF 

"ENDIF" 


ELSE 

CASE 

END»'CASE" 



WITH 

- . . - 1 

"ENDWITH" 



REPEAT 

UNTIL 



WHILE 

•’ENDWHILE" 



FOR 

1 

"ENDFOR" 




Module 

"CALL" 

Invocation 



c . #KEYWORDS FORTRAN 


Nulls out all currently defined keywords and establishes 
the following: 



Tnitiator 

Terminator 

Escape 

Substructure 

Module 

Structures 

SUBROUTINE 

END 

RETURN 

ENTRY 

PROCEDURE 

ENDPROCEDURE 

EXITPROCEDURE 


Block 

Structure 

DO 

CONTINUE 

L. - 




Module 

CALL 

Invocations 

GO 




d. ^KEYWORDS NONE 


Nulls out r\l the currently defined keywords. 

3) The names of the directives for definirg keywords have ccen changed 
as follows: 


^DEFINE 

MODULE 

has 

been changed 

to 

^MODULE 

^DEFINE 

BLOCK 

h.lS 

been changed 

to 

#BLOCK 

^DEFINE 

CALL 

has 

been changed 

to 

(fCALL 

1)DEFINE 

NULL 

has 

been changed 

to 

#NULL 


(For the sake of upward I'ompatibility, the old names are still 
recognized^ but their cnitinued use is discouraged.) 


* 4) The syntax of these keyword definition directives has been changed to 
allow synonyms for any structure component including the initiator . 
Specifically, punctuation is required to separate the structure 
components (i.e., Initiator, Terminator, Escape, Substructure). 
Keywords not separated by punctuation are taken as synonyms for the 
same component. 


*5) Definition of a keyword supercedes all previo t .j definitions of Chat 
keyword. All components of a given structure must be defrned in the 
same directive . Specifically, this means that the old method of 
defining synonyms for terminators, escapes, and substructures by 
naming the initiator in multiple directives will no longer work. 
Synonyms must be defined in the manner described in Item 4. 


6) I’he definition of terminator keywords has a new interpretation. If 
one or more terminators are defined for a given structure, then the 
first of these becomes the * ** default terminator ”, which is printed 
when the processor must force a structure termination (instead of 
ENDinitiator) . If no terminator is defined for a given structure, or 
if the specified default terminator has been nulled or redefined, 
then the structure will be closed automatically when necessary, but 
without printing a terminator statement . 

*7) The ^NULL directive applies only to keywords , not to character 

types. The old practice of NULLlng mark and string characters will 
no longer work. Instead, use the directives for defining character 
types, (See Item 8). 
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* 8 ) 


The set of directives for defining character types has been expanded 
and modified. Characters other than blanks, letters (upper and lower 
case plus #), and digits are initially of type punctuation, but may 
be interchangeably defined by the user as type mark, string, coinnent, 
or punctuation with the directives: 


^STRING 

ifoovmvn 

^PUNCTUATION 


character list 
character list 
character list 
character list 


title 

title 


The character list may contain any character currently of type mark, 
string, conr\ent, or punctuation. The new definition supercedes all 
previous definitions. Also, note that the syntax of the fi^MARK and 
^STRING directives has been changed. The list of characters now 
comes first , follow'^vd by the title of the cross-reference (if any) 
with which they are to be associated. The title begins with the 
first letter or digit encountered and continues to the last nonblank 
character of the statement. Finally, note that the #MARK directive 
now allows specification of at most one title . Use separate 
directives to associate marks with different cross-reference listings. 


9) An ^IDENTIFIER directive has been added to make it possible to get a 
cross-reference of identifiers which do not contain marks. The 
directive can take the forms* 

a. ^IDENTIFIER title 

Causes all unmarked identifiers to be recorded for 
inclusion in the cross-reference with the given title. 

b. ^IDENTIFIER 

Cancels the recording of unmarked Identifiers. Further 
occurrences of those already recorded are correctly 
cross-referenced, but no additional unmarked identifiers 
are recorded. 

(This directive is also recognized in its plural form: #IDENTIFIERS.) 

* 10) There is no longer an untitled (Null) cross-reference listing. 

Strings, identifiers, and mark characters not associated with a 
particular cross-reference title are not cross-referenced. 


11) Each token is now listed in the cross-reference listing(s) determined 
by the definitions in effect when the token is first encountered , 
even if those definitions are subsequently changed. As before, 
multiple directives referring to the same title result in a merged 
cross-reference listing. 



12) When a character defined by the #COM>Ctfr directive ai a comment 
delimiter ia found in the text> everything up to the next comment 
delimiter or the end of the statement is treated by the processor as 
a comment. Comments are printed in the output , but are otherwise 
ignored . 


13) An tfOPEN directive has been added so the user can initiate a block 
structure without a printed initiator statement. The directive has 
the forms: 

a. #OPEN 

Opens a new block with the current default indentation. 

b. #OPEN n 

Opens a new block indented by n columns. 


14) The name of the ^TERMINATE directive has been changed to y/ CLOSE in 
order to emphasize its complementary function to //OPEN. vFor the 
sake of upward compatibility^ the old name is still recognized^ but 
its continued use is discouraged.) Note that as before) the optional 
integer in this directive specifies the number of blocks to close and 
is unrelated to the optional indentation amount in #0PEN. Also note 
that for several reasons #OPEN and y^CLOSE do not have to be paired 
up . First) a single y/CLOSE can terminate more than one block 
structure. Second) y/GLOSE can be used to terminate blocks specified 
in the usual way with initiator statements. And third) since blocks 
specified by y^OPEN have no default terminator, they can be clo!;ed 
automatically by the processor (See Item 6). 

15) The name of the y/WIDTH directive has been changed to y)MARGlN and its 
capabilities extended so that both margins may now he specified. 

(For the sake of upward compatibility, the old name is still 
recognized, but its continued use is discouraged.) The directive can 
take the forms: 

a. y/MARGIN n 

Sets the left margin to column 1 and the right margin to 
column n. 

b'. #MARGIN n m 

y/MARGIN n punctuation character m 

Sets the left margin to column n and the right margin to 
column m. 
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C. #MARGIN 


i 

S 

i 

) 

j 


Restores the margins to their initial val’^es, 1 and 80. 
(This directive is also recognised in Its plural form: #MMIGINS.) 


* 16) A ^SPLIT directive has been added to allow the user to define a line 
split character and a character to be printed in its place. This 
directive is necessary if line splitting is to be used , since the 
feature is initially disabled. The directive can take the forms: 

a. tfSPLIT char 

Sets the split character to char and the character to be 
printed in its place to blank. 

b. #SPLIT Chari chai:2 

Sets the split ch.iracter to charl and the character to be 
printed in its place to char2. Note that charl and char2 
may be the same or different characters and that any 
charact ers may be used in this context without affecting 
their utage elsewhere. 

c. #SPLIT 

Restores the initial condition of line splitting disabled. 


17) A #LABEL directive has been added to allow specification of a "label 
field ” at Che beginning of each input line. These columns will be 
printed in the output but are otherwise ignored by the processor. 

The directive can take the forms: 

a. y^LABEL n 

Sets the number of label columns to n (maximum of 15 
columns). 

b . #LABEL 

Restores the number of label columns to the initial value 
of zero (labeling disabled). 


* 18) The <!tSEQUENCE directive now requires two values , the first and last 
columns of the sequence number field . This allows greater 
flexibility in that the input lines can now be variable lengths. 
However, when sequence columns are defined, these will be the last 
columns read and any additional columns will be ignored. The 
directive now has the forme: 


7 


a. #SEQUENCE \\ ra 

#SEQUENCE n punctuanlon character m 

Reierves columna n through m tot a sequence number (maximum 
oi 15 columns). 

b. li^SEQUENCB 

Restores the initial condition ot sequencinv^ disabled. 


* 19) The interpretation ot the tfSAMEPAGE directive has been changed 

slightly in order to make it a bit clearer and to allow nesting the 
ranges of multiple tfSAMEPAGE directives . The directive can take the 
forms: 

a. #SAMEPAGB r« 

Vntere n greater than Of this means , '’keep the next n 
modules together by suppressing the automatic page ejects 
between them." Note that the correct location for this 
directive is now before the first of the modules to be kept 
together instead of after this module. If a directive in 
this form specifies a range that lies entirely within the 
range of an earlier flSAMIPAOB directive , the new directive 
will have no effect. 

b. #SAMEPAGE 0 

fiSAMEPAGE 

Restores the initial condition of automatically ejecting a 
page between modules, thus cancelling the effect of any 
samepage range that is still open. 

Thus, it is possible to bracket a group of modules to be kept 
together by specifying a very large range and later cancelling it. 
Smaller, explicit ranges nested within a larger range will no longer 
affect the larger range. 


* 20) The input for < .EXT and #TITLE boxes must now be terminated with an 
explicit #END , rather than any line beginning with a # character. 

The number of lines which may be included in either kind of box is 
limited to what will fit on a single page of the output . Title boxes 
are always printed on a page ^themselves; text boxes are printed on 
the current page if there is sufficient room, on the next page 
otherwise. 
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21 ) 


A apeci«l ^SUPPRESS directive haa been added ao that certain 
proceaaor functiona may be diaabled on a given run. Thia directive 
ia unique in that it la only recognized if it appeara aa the firat 
atatenent in the input . It haa the fomu 

fjtSUPPRESS option liat 


The option liat may apecify any maaber of optiona^ with or without 
aeparating punctuation . The poaaible optlona and their meaninga are: 


a. NONKEY - *'Suppreoa nonkeyword (paaaive) atatementa." Thia 

reaulta in an abbreviated aource liating aince 
nonkeyword atatementa are not printed , and in ahorter 
croaa-*reference liatinga aince theae atatementa are 
not acanned for token occur rencea. (Correa ponda to 
the former D option.) 

b. ERRORS - "Suppreaa error mcaaagea." This auppreaaea the 

printing of error meaaagea and the flagging of 
proceaaor supplied atatementa but atill allowa them to 
be counted correctly. (Correa ponds to the former E 

option.) 


c. TOC -* "Suppreaa the Table of Contents." (Corresponds to the 

former T option.) 

d. MODTREE - "Suppress the Module Invocation Tree." (Corresponds 

to the former R option.) 


e. MODXREF - "Suppress the Module Cross-Reference Listing." 
(Corresponds to the former M option.) 


f. GENXREF - "Suppress the general (user defined) cross-reference 

listings." This suppresses cross-references for which 
titles are defined in #MARK, ^STRING, or <)IDENTIFIER 
directives. Remember that no untitled cross-reference 
is printed anyway. (See item 10.) 


In addition to the visible effects described above , most of these 
options will result in a reduction of memory requirements (often 
substantial) since no information is stored by the processor if it 
will not be needed later. For example, suppressing GENXREF will mean 
that most tokens and their lists of occurrences will not have to be 
stored. 


22) A variation of the ^SUPPRESS directive has been provided which will 
cause the directive itself to be bypassed . It has the form: 

^SUPPRESS any text 

Thus, by adding a # sign to the directive, its effect can be 
cancelled without physically removing it from the source file. 


NASA-jn.-C«nU LA., C*lil 
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